---
title: "Railway"
description: "Deploy Activepieces to the cloud in minutes using Railway's one-click template"
---

Railway simplifies your infrastructure stack from servers to observability with a single, scalable, easy-to-use platform. With Railway's one-click deployment, you can get Activepieces up and running in minutes without managing servers, databases, or infrastructure.

<a href="https://railway.com/deploy/kGEO1J" target="_blank">
  <img alt="Deploy on Railway" src="https://railway.app/button.svg" />
</a>

## What Gets Deployed

The Railway template deploys Activepieces with the following components:

- **Activepieces Application**: The main Activepieces container running the latest version from [Docker Hub](https://hub.docker.com/r/activepieces/activepieces)
- **PostgreSQL Database**: Managed PostgreSQL database for storing flows, executions, and application data
- **Redis Cache**: Redis instance for job queuing and caching (optional, can use in-memory cache)
- **Automatic SSL**: Railway provides automatic HTTPS with SSL certificates
- **Custom Domain Support**: Configure your own domain through Railway's dashboard

## Prerequisites

Before deploying, ensure you have:

- A [Railway account](https://railway.app/) (free tier available)
- Basic understanding of environment variables (optional, for advanced configuration)

## Quick Start

1. **Click the deploy button** above to open Railway's deployment interface
2. **Configure environment variables for advanced usage** (see [Configuration](#configuration) below)
3. **Deploy** - Railway will automatically provision resources and start your instance

Once deployed, Railway will provide you with a public URL where your Activepieces instance is accessible.

## Configuration

### Environment Variables

Railway allows you to configure Activepieces through environment variables. You can set these in the Railway dashboard under your project's **Variables** tab.

#### Execution Mode

Configure the execution mode for security and performance:
See the [Workers & Sandboxing](/docs/install/architecture/workers) documentation for details on each mode.

#### Other Important Variables

- `AP_TELEMETRY_ENABLED`: Enable/disable telemetry (default: `false`)

For a complete list of all available environment variables, see the [Environment Variables](/docs/install/configuration/environment-variables) documentation.

## Custom Domain Setup

Railway supports custom domains with automatic SSL:

1. Go to your Railway project dashboard
2. Navigate to **Settings** → **Networking**
3. Add your custom domain
4. Update `AP_FRONTEND_URL` environment variable to match your custom domain
5. Railway will automatically provision SSL certificates

For more details on SSL configuration, see the [Setup SSL](/docs/install/configuration/setup-ssl) guide.

## Production Considerations

Before deploying to production, review these important points:

- [ ] Review [Security Practices](/docs/security/practices) documentation
- [ ] Configure `AP_WORKER_CONCURRENCY` based on your workload and hardware resources
- [ ] Ensure PostgreSQL backups are configured in Railway
- [ ] Consider database scaling options in Railway

## Observability

Railway provides built-in observability features for Activepieces. You can view logs and metrics in the Railway dashboard.

## Upgrading

To upgrade to a new version of Activepieces on Railway:

1. Go to your Railway project dashboard
2. Navigate to **Deployments**
3. Click **Redeploy** on the latest deployment
4. Railway will pull the latest Activepieces image and redeploy

<Warning>
Before upgrading, review the [Breaking Changes](/docs/about/breaking-changes) documentation to ensure compatibility with your flows and configuration.
</Warning>

## Next Steps

After deploying Activepieces on Railway:

1. **Access your instance** using the Railway-provided URL
2. **Create your first flow** - see [Building Flows](/docs/flows/building-flows)
3. **Configure webhooks** - see [Setup App Webhooks](/docs/install/configuration/setup-app-webhooks)
4. **Explore pieces** - browse available integrations in the piece library

## Additional Resources

- [Troubleshooting](/docs/install/configuration/troubleshooting): Troubleshooting guide
- [Configuration Guide](/docs/install/configuration/overview): Comprehensive configuration documentation
- [Environment Variables](/docs/install/configuration/environment-variables): Complete list of configuration options
- [Architecture Overview](/docs/install/architecture/overview): Understand Activepieces architecture
- [Railway Documentation](https://docs.railway.app/): Official Railway platform documentation

